home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat4 / exports.z / exports
Encoding:
Text File  |  2002-10-03  |  10.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      exports - list of NFS filesystems being exported
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////eeeettttcccc////eeeexxxxppppoooorrrrttttssss
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The file /_e_t_c/_e_x_p_o_r_t_s describes the filesystems that are being exported
  16.      to NFS clients.  It is created by the system administrator using a text
  17.      editor It is processed by _e_x_p_o_r_t_f_s(1M) at system startup and by the mount
  18.      request daemon, _m_o_u_n_t_d(1M), each time a mount request is received.
  19.      _e_x_p_o_r_t_f_s should be re-executed after making changes to the file.
  20.  
  21.      The file consists of a list of filesystems, the _n_e_t_g_r_o_u_p(4) or machine
  22.      names allowed to remote mount each filesystem and possibly a list of
  23.      options.  The filesystem names are left justified and followed by a list
  24.      of names separated by white space.  The names are looked up in
  25.      /_e_t_c/_n_e_t_g_r_o_u_p and then in /_e_t_c/_h_o_s_t_s.  A hyphen indicates the start of
  26.      the options list.  Multiple options are separated by commas.  The default
  27.      options are rrrrwwww,,,,aaaannnnoooonnnn====nnnnoooobbbbooooddddyyyy.
  28.  
  29.      rrrroooo        Export the directory read-only.  If not specified, the
  30.                directory is exported read-write.
  31.  
  32.      rrrrwwww====_h_o_s_t_n_a_m_e[::::_h_o_s_t_n_a_m_e]...
  33.                Export the directory read-mostly.  Read-mostly means exported
  34.                read-only to most machines, but read-write to those specified.
  35.                If no hosts are specified, the directory is exported read-write
  36.                to all.
  37.  
  38.      aaaannnnoooonnnn====_u_i_d  If a request comes from a host for uid 0 (typically ``root'')
  39.                or from a host using null authentication, use _u_i_d as the
  40.                effective user ID.  _u_i_d can be either a name or an integer user
  41.                ID from /_e_t_c/_p_a_s_s_w_d.  The default value for this option is
  42.                ``nobody'' (uid -2).  Because uid 0 permits access to files
  43.                regardless of permission and ownership, NFS servers change uid
  44.                0 to the anonymous uid by default.  Use the rrrrooooooootttt option to
  45.                permit accesses from hosts using uid 0.  Setting the value of
  46.                _u_i_d to -1 disables accesses from unknown users or from root on
  47.                hosts not included in the rrrrooooooootttt option.
  48.  
  49.      rrrrooooooootttt====_h_o_s_t_n_a_m_e[::::_h_o_s_t_n_a_m_e]...
  50.                Give root access only to the root (uid 0) users from a
  51.                specified _h_o_s_t_n_a_m_e.  The default is for no hosts to be granted
  52.                root access.
  53.  
  54.      aaaacccccccceeeessssssss====_c_l_i_e_n_t[::::_c_l_i_e_n_t]...
  55.                Give mount access to each _c_l_i_e_n_t listed.  A _c_l_i_e_n_t can either
  56.                be a hostname, or a netgroup (see _n_e_t_g_r_o_u_p(4)).  Each _c_l_i_e_n_t in
  57.                the list is first checked for in the /_e_t_c/_n_e_t_g_r_o_u_p database and
  58.                then in the /_e_t_c/_h_o_s_t_s database.  The default value allows any
  59.                machine to mount the given directory.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  71.  
  72.  
  73.  
  74.      nnnnoooohhhhiiiiddddeeee    Allows a client who mounts this entry's parent filesystem to
  75.                access files in this filesystem.  This is ``off'' by default,
  76.                preventing a client who mounts this entry's parent filesystem
  77.                from accessing files in this filesystem.  Clients who mount a
  78.                filesystem containing a hidden filesystem access the directory
  79.                on which the hidden child is mounted, not the child
  80.                filesystem's root directory.  Be aware that using this option
  81.                introduces a violation of RFC 1094, RFC 1813, and the XNFS
  82.                specification.  Using this option may cause the server not to
  83.                interoperate properly with non-IRIX clients, particularly Linux
  84.                clients.
  85.  
  86.      wwwwssssyyyynnnncccc     Causes all writes to this filesystem to be performed
  87.                synchronously.  With this option, the server waits until
  88.                written data is safely stored on a magnetic disk or other non-
  89.                volatile medium before sending a positive response to the
  90.                client.  Without this option, the server performs delayed
  91.                writes (it responds positively to the client, then writes the
  92.                data at its convenience or when a _s_y_n_c(2) is executed).
  93.                Delaying writes provides a great performance boost, but also
  94.                introduces the risk of losing data if the server crashes after
  95.                the response but before the data is stored.  Use the wwwwssssyyyynnnncccc
  96.                option if this risk is unacceptable.
  97.  
  98.      33332222bbbbiiiittttcccclllliiiieeeennnnttttssss
  99.                Causes the server to mask off the high order 32 bits of
  100.                directory cookies in NFS version 3 directory operations.  This
  101.                option may be required when clients run 32-bit operating
  102.                systems that assume the entire cookie is contained in 32 bits
  103.                and reject responses containing version 3 cookies with high
  104.                bits on.  IRIX 5.3 and Solaris 2.5 are examples of 32-bit
  105.                operating systems with this behavior, which produces error
  106.                messages like "Cannot decode response" on directory operations.
  107.                XFS filesystems on the server can generate cookies with high
  108.                bits on.  Exporting filesystems with the 33332222bbbbiiiittttcccclllliiiieeeennnnttttssss option
  109.                causes these bits to be masked and prevents error messages.
  110.  
  111.      ffffssssiiiidddd====_i_d   This allows the administrator to set the fsid value that will
  112.                be returned in the fsid field of the attributes returned to the
  113.                client.  This number is arbitrary but must uniquely identify
  114.                the exported file system.  The purpose of this option is
  115.                twofold.  First it provides a mechanism by which FailSafe can
  116.                assign unique identifiers to exported file systems which may be
  117.                failed over.  This identifier can be the same on all nodes of
  118.                the cluster.  Secondly, it provides a way for administrators to
  119.                work around NFS clients written to interpret and in some cases
  120.                place restrictions on the fsid value returned in the
  121.                attributes.  If this option is used for this second purpose, it
  122.                should not be used in conjunction with the nohide option, and
  123.                the option should be used for all exported file systems.  It is
  124.                important to note that this option only affects the fsid
  125.                contained in the file attributes.  File handles are constructed
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. eeeexxxxppppoooorrrrttttssss((((4444))))                                                          eeeexxxxppppoooorrrrttttssss((((4444))))
  137.  
  138.  
  139.  
  140.                differently and do not use the fsid value in the file
  141.                attributes.
  142.  
  143.      A filesystem name that is not followed by a name list is exported to
  144.      everyone.  A ``#'' anywhere in the file indicates a comment extending to
  145.      the end of the line on which it appears.  A backslash ``\'' at the end of
  146.      a line permits splitting long lines into shorter ones.  When splitting
  147.      the options across multiple lines, the character immediately preceeding
  148.      the backslash must be one of ``-'', ``='', ``:'', or ``,''.  Also, no
  149.      whitespace may follow the backslash nor proceed the first character of
  150.      the next line.
  151.  
  152. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  153.           /usr/local               # export to the world
  154.           /usr      clients        # export to my clients
  155.           /usr2     bonnie clyde   # export to only these machines
  156.           /usr3     -anon=guest    # map client root & anonymous to guest
  157.           /         -ro            # export the root filesystem
  158.           /usr      -ro,nohide     # export all local filesystems read-only
  159.           /d/local/src   \
  160.                     -rw,anon=guest,root=bonnie    # multi-line example
  161.  
  162.      Exporting all your machine's local filesystems requires enumerating all
  163.      local mount points and using nnnnoooohhhhiiiiddddeeee for filesystem other than root:
  164.  
  165.           /         -ro
  166.           /usr      -ro,nohide
  167.           /d        -ro,nohide
  168.  
  169.  
  170. NNNNOOOOTTTTEEEE
  171.      The nnnnoooohhhhiiiiddddeeee and wwwwssssyyyynnnncccc options are specific to IRIX.
  172.  
  173. FFFFIIIILLLLEEEESSSS
  174.      /etc/exports
  175.  
  176. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  177.      exportfs(1M), mountd(1M), showmount(1M), netgroup(4), passwd(4).
  178.  
  179. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  180.      You cannot export a directory that is either a parent- or a sub-directory
  181.      of one that is currently exported and within the same filesystem.  It
  182.      would be illegal, for example, to export both /_u_s_r and /_u_s_r/_l_o_c_a_l if both
  183.      directories resided in the same disk partition.
  184.  
  185.      While there is no hard-coded maximum length, extremely long export lists
  186.      (hundreds of hosts or netgroups for a single exported directory) may
  187.      cause mount requests for that exported directory to time out.
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.